<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
    <head>
        <title></title>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>
    <body>
        <div>
            <a href="index.html">Go to Main Page</a>
            <a name="top"></a>
            <h1>General</h1>
            <p>
               Start the socket server by pressing on the start button. Upon the server start a socket server will bet created listening to a port specified on the server settings.
               To stop the socket server simply press the stop button. This will close all clients connection and free the resources used on the process.
            </p>

               <br>
               
            <h3><i>Before you start the server</i></h3>
               
            <ol>
                <li>Make sure that the MQTT Broker is running. For instruction on how to run the MQTT Broker <a href="#runningbroker">click here</a> or go to the section below. </li>
                <li>Check that all settings are set and that the values are correct. Information on setting up server settings is in the next chapter below.</li>
            </ol>
               
            <hr>
            
            <h2>About Server Settings</h2>
            <p>
                It is very important that all information set in the server settings are correct to insure a proper running socket server. The option to edit and save server settings
                are available on the menu bar on top of th e main window or by hit the following shortcut keys "Ctrl+Alt+S" on your keyboard. Additional information are available on 
                each settings by clicking on the info button next to the field[right side of the text field].
            </p>
            
            <p>
                Information on the following settings will be explain one by one. 
            </p>
            
            <ul>
                <li><b>Server name</b></li>
                <li><b>Server Port</b></li>
                <li><b>Broker Address</b></li>
                <li><b>Broker Port</b></li>
                <li><b>Options file path</b></li>
                <li><b>External Program path</b></li>
            </ul>
             
            <p>
            <b>Server name - </b>A non functional dependant option. Provide a name for the server or use the local machine name by checking the check box under the text field.    
            </p>
            
            <p>
            <b>Server Port - </b>Enter a port number to be used by the socket server. The default port number is 1883. To find out which port number is assigned to an 
            application or currently being used by other running processes, use the netstat function in the command window(on Windows OS only). 
            For instruction <a href="instructions.html">click here</a>.
                
            </p>
            
            <p>
            <b>Broker Address - </b>Provide the Machine's IP-address where the MQTT Broker currently installed. It is important that the right address(IP) is provided for the 
            application to work properly. If the broker is installed on the same machine as this application an easier functionality is provided to locate 
            the machine's IP-address by checking the check box under the text field. Alternatively, typing "localhost" will be acceptable given that the MQTT broker reside locally.
            </p>
            
            <p>
            <b>Broker Port - </b>Enter a port number being used by the MQTT broker. The default port number is 1883. To find out which port number is assigned to an 
            application or currently being used by other running processes, use the netstat function in the command window(on Windows OS only). 
            For instruction <a href="instructions.html">click here</a>.
            </p>
            
            <p>
            <b>Options file path - </b>the location of the "option.txt"-file used by the 3D motion tracking system. For more convenient used, browse 
            through folders by using the search function to locate the file by clicking on the button next to the text field. This option is located 
            on the "Files and Directories"-tab on the Server Settings options.
            </p>
            
            <p>
            <b>External Program path - </b>the location of the executable-file used to run the 3D motion tracking system application. For more convenient used, browse 
            through folders by using the search function to locate the file by clicking on the button next to the text field. This option is located 
            on the "Files and Directories"-tab on the Server Settings options.    
            </p>
            
            <hr>
            
            <h2>
                <a name="runningbroker"></a>
               Running MQTT Broker [Windows]
            </h2>
            
            <p>
               MQTT Broker
            </p>
            
            <p>
                For instruction on how to run MQTT Broker <a href="brokerinstructions.html">click here</a>.
            </p>
            
            <br>
            
            <a href="#top">[Top]</a>
        </div>
    </body>
</html>
